home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / X11 / XSelectInput.z / XSelectInput
Encoding:
Text File  |  1998-10-30  |  4.0 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeelllleeeeccccttttIIIInnnnppppuuuutttt((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXSSSSeeeelllleeeeccccttttIIIInnnnppppuuuutttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSelectInput - select input events
  10.  
  11.      SSSSYYYYNNNNTTTTAAAAXXXX
  12.           XSelectInput(_d_i_s_p_l_a_y, _w, _e_v_e_n_t__m_a_s_k)
  13.                 Display *_d_i_s_p_l_a_y;
  14.                 Window _w;
  15.                 long _e_v_e_n_t__m_a_s_k;
  16.  
  17.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  18.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  19.  
  20.           _e_v_e_n_t__m_a_s_k
  21.                     Specifies the event mask.
  22.  
  23.           _w         Specifies the window whose events you are
  24.                     interested in.
  25.  
  26.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  27.           The _X_S_e_l_e_c_t_I_n_p_u_t function requests that the X server report
  28.           the events associated with the specified event mask.
  29.           Initially, X will not report any of these events.  Events
  30.           are reported relative to a window.  If a window is not
  31.           interested in a device event, it usually propagates to the
  32.           closest ancestor that is interested, unless the
  33.           do_not_propagate mask prohibits it.
  34.  
  35.           Setting the event-mask attribute of a window overrides any
  36.           previous call for the same window but not for other clients.
  37.           Multiple clients can select for the same events on the same
  38.           window with the following restrictions:
  39.  
  40.           +o    Multiple clients can select events on the same window
  41.                because their event masks are disjoint.  When the X
  42.                server generates an event, it reports it to all
  43.                interested clients.
  44.  
  45.           +o    Only one client at a time can select _C_i_r_c_u_l_a_t_e_R_e_q_u_e_s_t,
  46.                _C_o_n_f_i_g_u_r_e_R_e_q_u_e_s_t, or _M_a_p_R_e_q_u_e_s_t events, which are
  47.                associated with the event mask
  48.                _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k.
  49.  
  50.           +o    Only one client at a time can select a _R_e_s_i_z_e_R_e_q_u_e_s_t
  51.                event, which is associated with the event mask
  52.                _R_e_s_i_z_e_R_e_d_i_r_e_c_t_M_a_s_k.
  53.  
  54.           +o    Only one client at a time can select a _B_u_t_t_o_n_P_r_e_s_s
  55.                event, which is associated with the event mask
  56.                _B_u_t_t_o_n_P_r_e_s_s_M_a_s_k.
  57.  
  58.           The server reports the event to all interested clients.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeelllleeeeccccttttIIIInnnnppppuuuutttt((((3333XXXX11111111)))) XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))  XXXXSSSSeeeelllleeeeccccttttIIIInnnnppppuuuutttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.           _X_S_e_l_e_c_t_I_n_p_u_t can generate a _B_a_d_W_i_n_d_o_w error.
  75.  
  76.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  77.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  78.                     defined Window.
  79.  
  80.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  81.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.